home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
kermit.columbia.edu
/
kermit.columbia.edu.tar
/
kermit.columbia.edu
/
newsgroups
/
misc.20010921-20020314
/
000247_fdc@columbia.edu_Sat Dec 15 13:21:53 EST 2001.msg
< prev
next >
Wrap
Text File
|
2002-03-13
|
3KB
|
61 lines
Article: 13072 of comp.protocols.kermit.misc
Path: newsmaster.cc.columbia.edu!news.columbia.edu!news-not-for-mail
From: fdc@columbia.edu (Frank da Cruz)
Newsgroups: comp.protocols.kermit.misc
Subject: Re: C-Kermit 8.0 files/installation?
Date: 15 Dec 2001 13:20:53 -0500
Organization: Columbia University
Lines: 44
Message-ID: <9vg4a5$mc0$1@watsol.cc.columbia.edu>
References: <9vb3i1$989$1@watsol.cc.columbia.edu> <N%LS7.255$fb1.172478@news.uswest.net>
NNTP-Posting-Host: watsol.cc.columbia.edu
X-Trace: newsmaster.cc.columbia.edu 1008440454 20605 128.59.39.139 (15 Dec 2001 18:20:54 GMT)
X-Complaints-To: postmaster@columbia.edu
NNTP-Posting-Date: 15 Dec 2001 18:20:54 GMT
Xref: newsmaster.cc.columbia.edu comp.protocols.kermit.misc:13072
In article <N%LS7.255$fb1.172478@news.uswest.net>,
<robert@bonomi.invalid> wrote:
: Comment: Documentation in HTML is nice, "pretty", makes it easy to cross-
: reference things. All good reasons for using it.
:
: *HOWEVER*, please don't make it the _only_ form that things are
: available in! Sometimes a web-browser is *NOT* 'conveniently
: available'. "Plain text" is *universally* readable with simple
: tools, and can be much faster to use to find specific info. e.g.,
: vi and a '/' search, will have the job done, _before_ a browser
: finishes initializing itself.
:
All of that should go without saying. The text files that were converted
to html are also all dumped back out as text. We didn't convert to html
because it was pretty, we did it so we could link to specific sections of
specific documents in tech-support e-mail and newsgroup postings, so people
could click on the links and get the info immediately and directly.
: As an alternative, consider what Hylafax does -- it provides for
: customizations in the Makefile as for where to install the configuration
: files and secondary documentation. the makefile target for installing the
: manpages includes editing to indicate the _actual_ locations on the
: installed system.
:
The new makefile announced yesterday does this with "make install":
ftp://kermit.columbia.edu/kermit/test/text/makefile
: This is indicative of a 'documentation failure', not a flaw in the approach.
: And much easier to remedy. Appropriate language in the release announcement
: and the 'download' web-page -- e.g. "downloading the Supplement is _not_
: necessary for a working Kermit installation"
:
See what you think about the wording here:
http://www.columbia.edu/kermit/ckuins.html#x5
: Suggest, despite your prior 'confusion' experience, multiple tarballs.
:
Done:
http://www.columbia.edu/kermit/ckuins.html#x1
- Frank